--------------------------------------------------------------------------
3M Touch Systems
MicroTouch (TM) Near Field Imaging (TM) Touch Screen Drivers and Utilities
For Windows 9X operating system
--------------------------------------------------------------------------


This file contains the following sections:

	1. Installation Diskette
	2. How to Install/Upgrade the Touch Screen Software
	3. Concurrent Mouse and Touch Screen Operation
	4. Exporting/Importing Touch Screen Configurations
	5. New Features Not Described in Manual
	6. Uninstalling the Touch Screen Drivers software
	7. Developer Touch Error Detection


1.  INSTALLATION DISKETTE
-------------------------

The 3M MicroTouch Touch Screen Driver Disk contains all the software you need
to use an NFI touch screen and NFI touch controller with Windows 9x.
Included on this diskette are the touch screen driver and configuration
utilities.

The following files are contained on this installation diskette:

    INSTALL.EXE - Installation utility

    VNFID.VXD	- Touch Screen Virtual Device Driver (DTC)
    VNFID.INF   - Installation script used by Windows 9x
    README.TXT	- This file

    TOUCHCFG.EXE- Touch Screen Configuration Utility executable
    TOUCHCFG.HLP- Touch Screen Configuration Utility help file
    TOUCHINI.EXE- Touch Screen Configuration Import/Export Utility
    TOUCHERR.EXE- Touch Screen Startup Log Utility executable
    TOUCHERR.DLL- Touch Screen Startup Log Devloper Dynamic Link Library
    MBSWAP.EXE  - Mouse Button Selector Utility executable
    MBSWAP.HLP  - Mouse Button Selector Utility help file
    NSD.EXE     - NFI Setup and Diagnostic Utility
    NFISETUP.EXE - NFI Setup Wizard

    TOUCHOSI.DLL- Touch Screen Dynamic Link Library
    MSVCRT.DLL  - Touch Utilities Dynamic Link Library
    XNMBA458.DLL- Touch Utilities Dynamic Link Library
    XNMHN458.DLL- Touch Utilities Dynamic Link Library
    XNMTE458.DLL- Touch Utilities Dynamic Link Library

    UNINSTAL.EXE- Uninstallation utility.
    UNINSTAL.INF- Uninstallation script file.
    INSX16.DLL  - Uninstallation Dynamic Link Library
    INSX32.DLL  - Uninstallation Dynamic Link Library



2.  HOW TO INSTALL/UPGRADE THE TOUCH SCREEN SOFTWARE
----------------------------------------------------

To install or upgrade the software onto your computer, you must have
Windows 9x running and a floppy disk drive.  Follow these steps:

1.  From the "Start" menu, select "Run". Enter the full path to the
    installation utility in the "Open" field (e.g. A:\install.) 
    You can use the "Browse" button to find the install utility. 
    Choose OK to continue.

2.  The "Dynapro Touch Screen installation" window will appear and 
    the first dialog will display the following information: 
    driver version, touch screen configuration, target directory and
    target folder.  You will not be able to change any of this
    information. Select "Next" to proceed with the installation.

3.  The next dialog will enable you to select the communication port for
    the Touch Screen operation. Select the desired port from the list of 
    standard ports or define a custom port using the "Interrupts"
    and "I/O Address" lists. Select "Back" to go to the previous 
    dialog, select "Cancel" to abort the installation or select "Next" 
    to proceed with the installation.

4.  The last dialog will display all the entered installation information.
    If you are satisfied with your choices, select "Install" to start the
    installation.  All installation steps will be displayed on the screen.
    Once installation has been completed, you will be prompted to restart
    Windows 9x.  Select "Yes" to do so.  When Windows 9x restarts, the
    touch screen will be operational.

5.  The touch screen must be aligned after installation to ensure proper 
    operation.  Alignment ensures the touch screen is oriented and aligned
    with the video display.  To do this use the "Configuration" item from
    the "Touch Screen Utilities" start sub-menu.  Select "Alignment" and
    then press the "Alignment" button.  Follow the prompts, touching where
    instructed.  When satisified with the alignment, choose "Ok" to both save
    and active the alignment points defined.

The installation process places the files contained on the installation 
diskette into the following locations, on the hard drive where your Windows 9x
directory resides:

    \TOUCH\W9x
        README.TXT
        TOUCHCFG.EXE
        TOUCHCFG.HLP
        TOUCHINI.EXE
        TOUCHERR.EXE
        MBSWAP.EXE
        MBSWAP.HLP
        NSD.EXE
        NFISETUP.EXE

        MSVCRT.DLL
        XNMBA458.DLL
        XNMHN458.DLL
        XNMTE458.DLL

        UNINSTAL.EXE
        UNINSTAL.INF
        INSX16.DLL
        INSX32.DLL

    \WINDOWS\SYSTEM
        VDTCD.VXD
        TOUCHERR.DLL



3.  CONCURRENT MOUSE AND TOUCH SCREEN OPERATION
-----------------------------------------------

The Windows 9x Touch Screen driver supports concurrent mouse and touch 
screen operation.  To facilitate this, you must ensure that an appropriate
driver is installed for your mouse.  The recommended way for to achieve
this is via the "Add New Hardware" Wizard in the Control Panel.  Connect
your mouse to the computer and instruct the Wizard to search for new
hardware by selecting "Yes" at the prompt on the first screen.  Do NOT
select "No" and manually choose a mouse driver.

Once the Add New Hardware Wizard has detected your mouse and installed
the appropriate mouse driver, your mouse will work concurrently with
the touch screen.

If the Wizard fails to detect your mouse, then it can not be used
concurrently with the touch screen.  A mouse that is detectable by
Windows 9x, such as a Microsoft or Logitech mouse is required.



4.  EXPORTING/IMPORTING TOUCH SCREEN CONFIGURATIONS
---------------------------------------------------

Included with this software is a Touch Screen Configuration Import/Export 
Utility (TOUCHINI.EXE).  Installed with the touch screen software, this 
utility is located in the \TOUCH\W9x directory.  The utility allows you 
to configure the touch screen driver by importing a file containing the 
configuration data into the Windows 9x Registry.  It will also extract the
current touch screen configuration from the Registry and write it to a file.

By using the TOUCHINI utility, you can easily generate a configuration file
that may be copied to other computers and then imported without requiring 
manual configuration of each unit.

Exporting:
---------

To export the current configuration from the Windows 9x Registry into a
file, execute the following command from a Windows 9x DOS command prompt:

        TOUCHINI /o

This creates a file called TOUCH.INI, which contains an ASCII representation
of the touch screen configuration.  You can override the default filename
by specifying a file after the /o command line option (for example,
"TOUCHINI /oCONFIG.INI").  This file can later be used to import the same
configuration into your unit, as per the import instructions which follow.

Importing:
---------

To import a previously exported touch screen configuration file into the
Windows 9x Registry execute the following command from a Windows 9x DOS
command prompt:

        TOUCHINI /i[file name]

where [file name] is the name of the file you previously exported to
(like CONFIG.INI in the above example).  The new configuration will take
effect the next time you restart Windows 9x.

IMPORTANT: all previous touch screen configuration is erased during the
           import process except alignment and communication port data.



5. NEW FEATURES NOT DESCRIBED IN MANUAL
---------------------------------------

NFI SENSITIVITY
---------------

If you are using a Dynapro NFI touch screen, you can adjust the sensitivity of
the touch detection for your touch screen by selecting the sensitivity button
from within the the Interface Configuration Options dialog.  Sensitivity
ranges from low to high with six discrete levels as described below.  

1. Low is the least sensitive and is best for large size bare fingers.
2. Best for medium to large size bare fingers.
3. The default setting which is for average size bare fingers.
4. Best for cotton gloved fingers.
5. Best for suede gloved fingers.
6. High is the most sensitive and is best when wearing thick rubber gloves.

Please Note: These sensitivity descriptions are approximate and are subject
to change depending on the environmental influences surrounding the unit.

After selecting sensitivity using the slider bar provided, you can test
the new settings before applying them by the test button.  To apply your
selected setting press OK, or to quit and revert back to the previous setting
press Cancel.



6. UNINSTALLING THE TOUCH SCREEN DRIVER SOFTWARE
------------------------------------------------

To uninstall the touchscreen software you can use utility placed on your
Touch Screen directory "\TOUCH\W9x".
From the "Start" menu, select "Run" and enter the full path to the 
uninstallation utility (e.g. C:\TOUCH\W9x\UNINSTAL.EXE) and follow the
on-line instructions.



7. DEVELOPER TOUCH ERROR DETECTION
-----------------------------------------

Application Developers can use the supplied Dynamic Link Library -
"toucherr.dll" to detect touch screen and controller errors during startup.
The DLL provides a single function "C" API that reads startup errors from the
registry and returns the error string to the caller.

Interface Specification:

function - TouchGetErrorLogString

  The TouchGetErrorLogString function retrieves the data for the touch 
  error log value asociated with the DYNAPRO registry key. 

  LONG TouchGetErrorLogString
  ( 
    CHAR *pszBuffer,         /* pointer to pre-allocated char buffer */
    LONG *pnBufferSize       /* size of the above char buffer */
  ) 

 
Parameters:

  - pszBuffer

  Pointer to a buffer that receives the value's data. This parameter can be NULL
  if the data is not required. 

  - pnBufferSize

  A pointer to a variable that specifies the size, in bytes, of the buffer pointed
  to by the pszBuffer parameter. When the function returns, this variable
  contains the size of the data copied to pszBuffer parameter. 

  If the buffer specified by pszBuffer parameter is not large enough to hold the
  data, the function returns the value ERROR_MORE_DATA, and stores the required
  buffer size, in bytes, into the variable pointed to by pnbufferSize. 

  If pszBuffer is NULL, and nBufferSize is non-NULL, the function returns
  ERROR_SUCCESS, and stores the size of the data, in bytes,
  into the variable pointed to by pnbufferSize.

Return Values

  If the function succeeds, the return value is ERROR_SUCCESS.

  If the function fails, the return value is an error code as defined
  in WINERROR.H.

Sample Application Code:

  The following is a sample of code used to access the dll and retrieve
  the ErrorLog Value:

/* declarations */
typedef LONG (CALLBACK* LPFNDLLFUNC)(CHAR *,LONG *);
#define nERRORLOG_SIZE_MAX  1024

...

LONG YourErrorCheckFunction()
{
    CHAR         szValueBuffer[nERRORLOG_SIZE_MAX];
    LONG         nValueBufferSize = nERRORLOG_SIZE_MAX;
    LONG         status = ERROR_SUCCESS;
    HINSTANCE    hDLL;                      /* Handle to DLL */
    LPFNDLLFUNC  lpfnDllFunc;               /* function pointer */

    hDLL = LoadLibrary("TOUCHERR.DLL");

    if (hDLL != NULL)
    {
         lpfnDllFunc = (LPFNDLLFUNC) GetProcAddress(hDLL,"TouchGetErrorLog");

         if (!lpfnDllFunc)
         {
             /* handle error */
             status = ERROR;   
         }
         else
         {   
             /* call the function */
	     status = lpfnDllFunc1(szValueBuffer,&nValueBufferSize);
	     /* Buffer now contains error message if any */
         }

    FreeLibrary(hDLL);
    }
    return status;
}



---------------------------------------------------------------------
For more service and technical information in Canada and the USA:
Telephone from Canada or the USA (toll free): 1-866-407-6666
Telephone from outside Canada and the USA: 1-978-659-9200
Fax: 1-978-659-9400
Email: US-TS-Tech_Support@mmm.com 
--------------------------------------------------------------------


COPYRIGHT
This document is  3M 2002. All rights reserved. 
Reproduction of the contents of this copyrighted manual in whole or in part, by any means, electronic or mechanical, for any purpose, without written permission of 3M Touch Systems, a subsidiary of 3M, is prohibited.

NOTICE
Given the variety of factors that can affect the use and performance of a 3M Touch Systems product, including that solid state equipment has operation characteristics different from electromechanical equipment, some of which factors are uniquely within Users knowledge and control, it is essential that User evaluate the 3M Touch Systems product to determine whether it is suitable for Users particular purpose and suitable for Users method of application. 3M Touch Systems statements, engineering/technical information, and recommendations are provided for Users convenience, but their accuracy or completeness is not warranted. 3M Touch Systems products are not specifically designed for use in medical devices as defined by United States federal law. 3M Touch Systems products should not be used in such applications without 3M Touch Systems express written consent. User should contact its sales representative if Users opportunity involves a medical device application.

IMPORTANT NOTICE TO PURCHASER
Specifications are subject to change without notice. 3M Touch Systems Products are warranted to meet their published specifications from the date of shipment and for the period stated in the specification. 3M Touch Systems makes no additional warranties, express or implied, including but not limited to any implied warranties of merchantability or fitness for a particular purpose. User is responsible for determining whether the 3M Touch Systems products are fit for Users particular purpose and suitable for its method of production, including intellectual property liability for Users application. If a Product is proven not to have met 3M Touch Systems warranty, then 3M Touch Systems sole obligation and Users and Purchasers exclusive remedy, will be, at 3M Touch Systems option, to repair or replace that Product quantity or to refund its purchase price. 3M Touch Systems has no obligation under 3M Touch Systems warranty for any Product that has been modified or damaged through misuse, accident, neglect, or subsequent manufacturing operations or assemblies by anyone other than 3M Touch Systems. 3M Touch Systems shall not be liable in any action against it in any way related to the Products for any loss or damages, whether non-specified direct, indirect, special, incidental or consequential (including downtime, loss of profits or goodwill) regardless of the legal theory asserted. (Last revised: 11/01)


TRADEMARKS
Near Field Imaging, Dynapro, and MicroTouch are trademarks of 3M.
All other brand and product names are trademarks or registered trademarks of their respective companies, specifically Windows (of Microsoft) and Logitech, and are hereby acknowledged.

--------------------------------------------------------------------
